home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_6 / xbj113.lha / XBJ.DOC < prev   
Text File  |  1994-09-27  |  5KB  |  134 lines
  1.  
  2.                       Al's Blackjack Casino
  3.  
  4.               Alan Bland                Quarter Note
  5.               442 Seven Hills Drive    (303)939-9923
  6.               Boulder, CO 80302 USA      1:104/121
  7.  
  8.     Copyright (c) 1991-1994 by Alan Bland, All Rights Reserved
  9.  
  10.       XBJ is freely distributable as long as the program is
  11.       not modified in any way, and the copyright notice when
  12.       the program starts remains intact.
  13.  
  14.       The latest version of Al's Blackjack Casino is always
  15.       available by file requesting CASINO from 1:104/121.
  16.  
  17.  
  18. WHAT IS IT?
  19. -----------
  20.  
  21. Al's Blackjack Casino (XBJ) is a Blackjack game door for Amiga BBS
  22. systems.  It was originally written as a Xenolink-specific game, but
  23. was later changed to use the standard CLI protocol used by nearly
  24. every BBS program on the Amiga.  Al's Blackjack Casino has worked on
  25. DLG, Xenolink, Transamiga, CNet, and probably others that I have not
  26. heard about.
  27.  
  28. I currently run DLG and do all my testing with DLG, so I cannot make
  29. any guarantees that it will work with any other BBS program.
  30.  
  31. Al's Blackjack Casino plays a basic one-player Blackjack game, uses
  32. ANSI color graphics, and maintains a high-score file so your BBS users
  33. can compete against each other for the number one spot!  The high
  34. scores are reset at the beginning of every month, so it's easy to run
  35. monthly contests among your users.
  36.  
  37. Al's Blackjack Casino is freeware.  Install it on your BBS and let
  38. your users have fun.  If you like this program, I'd appreciate hearing
  39. your comments.
  40.  
  41.  
  42. INSTALLATION FOR DLG 1.0
  43. ------------------------
  44.  
  45. Create a directory named DOORS:XBJ and copy the XBJ executable file
  46. there.  Use the following menu entry:
  47.  
  48.          Executable:  doors:xbj/xbj -u "%NAME" -p %PORT
  49.         Description:  Al's Blackjack Casino
  50.                Type:  Executable
  51.           Load type:  Overlay
  52.       Pend messages:  Yes
  53.            Cli mode:  No
  54.  
  55. The -p is optional and tells XBJ which DLG port it's running on.
  56. If -p is specified, XBJ will display DLG broadcast messages at the
  57. bottom of the screen.
  58.  
  59.  
  60. INSTALLATION FOR OTHER BBS PROGRAMS
  61. -----------------------------------
  62.  
  63. Create a directory named DOORS:XBJ and copy the XBJ executable file
  64. there.  Tell your BBS software to run the following CLI command:
  65.  
  66.    doors:xbj/xbj -u "user's name"
  67.  
  68.  
  69. CONFIGURATION FILE
  70. ------------------
  71.  
  72. XBJ reads a configuration file, DOORS:XBJ/XBJ.CFG.  An example
  73. configuration file is provided.  You should edit the example
  74. configuration file to customize XBJ to your needs.
  75.  
  76. The configuration file consists of keywords and values.  You may
  77. specify the keywords in any order, and you may mix upper and lower
  78. case letters.  Lines beginning with a ";" are ignored.
  79.  
  80. If you do not install the XBJ.CFG file, reasonable defaults will be
  81. used.
  82.  
  83. See the comments in the supplied XBJ.CFG file for all the possible
  84. configuration options.
  85.  
  86.  
  87. MONTHLY SCORE FILES
  88. -------------------
  89.  
  90. The user scores get reset the first time the game is played each
  91. month.  The files listed below are maintained by XBJ in the DOORS:XBJ
  92. directory.  Normally XBJ will handle these files automatically; you
  93. should never have to do anything with them.
  94.  
  95.    xbj.users       This contains the current month's scores and other
  96.                    per-user information.  Delete this file if you want
  97.                    to reset all scores.
  98.  
  99.    xbj.users.last  This contains last month's per-user data.  It's not
  100.                    really used, but is kept around in case you need to
  101.                    restore it.
  102.  
  103.    month.file      This file controls when XBJ decides to begin a new
  104.                    month.  You only need to worry about this file if
  105.                    you manage to mess up the date on your Amiga, or if
  106.                    nobody plays XBJ for more than a month.  This file
  107.                    contains the month number (0-11) when XBJ last wrote
  108.                    the score files.  XBJ will switch to a new month
  109.                    when the current month is different from this value.
  110.                    HOWEVER, IF XBJ DETECTS THAT THE MONTH HAS SKIPPED
  111.                    BY MORE THAN A SINGLE MONTH, IT WILL DISPLAY AN
  112.                    ERROR AND WILL NOT UPDATE THE SCORES.  This protects
  113.                    you from hosing your scores if your Amiga's clock
  114.                    goes bonkers.  You can delete this file, whereupon
  115.                    XBJ will assume the current month is correct.  You
  116.                    can also edit the value in this file to fix it, but
  117.                    that's not recommended.
  118.  
  119. The high scores are also maintained as text files that you can display
  120. as bulletins.  XBJ can optionally create these files as plain ASCII,
  121. 16-color ANSI, or using DLG ANSI codes.  See the XBJ.CFG file for
  122. details.
  123.  
  124.  
  125. CARRIER LOSS AND MULTIPLE NODES
  126. -------------------------------
  127.  
  128. Just so you know, XBJ detects carrier loss and updates the user's
  129. score and daily time used.  There's no way to avoid the daily time
  130. limit, or to abort a bad gaming session without updating the score
  131. file.  The score files are locked to prevent multiple nodes from
  132. clobbering each other, so you can run as many simultaneous copies of
  133. XBJ you wish.
  134.